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(57) A method is provided for controlling a network 
element from a client at a remote work station connect- 
able to the network, the network, element is registered 



for attributes to be tracked, and attributes associated 
with the network element are polled only If the client re- 
quests the monitoring of the network element. 
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Description 

Background Of The Invention 

s [0001] This invention relates, generally, to a method for controlling a network element and, more particularly, to a 
method for remotely controlling the network by communications through the network. 

[0002] Network management systems in which network elements, or management agents, are remotely controlled 
from a remote, management work station by means of communications between the management work station and 
the managed network elements sent through the network are known. Such known network management systems 
10 employ a special communication protocol for communications between the remote work station running a management 
program and an element management server that contains a management information base that defines the interface 
between the work station and the network elements. 

[0003] Known systems such as (Hewlett Packard HP-OV NNM or DM, Sun Microsystems Solstice) present an in- 
terface where the client application must poll the network element when status is needed. In these systems, the polling 
15 may not be coordinated and is replicated for each client, if each client is interested in the same attributes. Also, each 
of the clients receive the full results for each polling cycle (even if there was no change from the last cycle), increasing 
the bandwidth used to communicate between the client application and the network element, as welt as creating ad- 
ditional processing overhead due to the replicated polling at the network element. 

20 Summary Of The Invention 

[0004] A method is provided for controlling a network element from a remote work station connectable to the network. 
The method provides for registering the network element for attributes to be tracked, and polling for attributes associated 
with the network element only if the client requests the monitoring of the network element. Changes in attributes are 
25 reported when the client requests notification of changes in attributes. For attributes polled for a plurality of clients, 
changes in the attributes to one of the plurality of clients requesting notification of changes in the attributes are reported. 
[0005] The method further provides for polling once for a plurality of clients that registers for the same attributes and 
reporting asynchronously changes in the attributes to a plurality of clients. 

[0006] Another aspect of the invention provides for running an object oriented program at the remote work station 
30 to control an object associated with the controllable network element, translating interface operations generated by 
the work station during the running of the object oriented program to corresponding translated interface operations in 
an object oriented language associated with the object being controlled, and connecting the corresponding translated 
interface operations through the network to an object server to control the object associated with the network element 
in accordance with the translated interface operations. 
35 [0007] These and other features and advantages of the present invention will become apparent from the following 
detailed description, the accompanying drawings and the appended claims. 

Brief Description Of The Drawings 

40 [0008] The foregoing advantageous features will be described in detail and other advantageous features of the in- 
vention will be made apparent from the detailed description of the preferred embodiment of the invention that is given 
with reference to the several figures of the drawings, in which: 

Fig. 1 is a functional block diagram of the preferred embodiment of a management system using the preferred 
45 network element control method of the present invention; 

Fig 2 is a functional block diagram of the preferred embodiment of the translating interface shown as a single 
functional block in Fig. 1; 

Fig. 3 is a functional block diagram illustrating the interface with the controlled network element that is visible to 
object oriented client management application at the work station of Fig.1 ; 

Fig. 4 is a table of a plurality of service objects that interact with the client management application run at the work 
station of Fig. 1 ; 
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Fig. 5 is a table of a plurality of call back functions performed at the translating interface of Fig.2; 

Fig. 6 is a table of the different fundamental data types capable of being translated by the translating interface of 



BNSDOCID: <EP 0998076A1_L> 



EP 0 998 076 A1 

Fig. 2 in accordance with the invention. 

Fig. 7 is a block diagram showing the relationship between client application-specific service object, and the internal 
service representative of managed object instances; 

5 

Fig. 8 is a table summarizing filter criteria that is valid for each event category; and 

Fig. 9 is a table defining specific exceptions with an EMAPI exception code containing one of the listed values. 
10 Detailed Description 

[0009] This invention provides an application programming interface (API) and protocol that provides for efficient 
communication between a distributed client application and an element management server independent of the com- 
munication protocol to the network element. The Element Management Application Programming Interface (EMAPI) 

f5 provides the following benefits over known management system. The invention has application in the management of 
a telecommunication network element. For more information regarding such a management of a telecommunication 
network element refer to commonly owned U. S. patent application serial number 09/088,463, entitled "Method for 
Computer Internet Remote Management of a Telecommunication Network Element" by William E. Barker, Lisa M. 
Connelly, Marvin A. Eggert, Michael P. Foley. Kenneth R. Macfarlane, Philip M. Parsons, Girish Rai, Jerome E. Rog, 

20 and Kurt A. Vangsness, filed on May 31, 1998, the disclosure of which is hereby incorporated by reference. 

• Efficient use over low bandwidth connections. Client applications register for network element information they 
wish to track and after an initial set of data only receive incremental updates (deltas) when there are changes. 

25 • Centrali2ed polling of attributes. Attributes are only polled if a client exists that has registered to monitor the attribute. 

If multiple clients register for the same attribute(s), the polling Is not repeated for the clients-only a single polling 
cycle is performed. 

[0010] The invention is used in an operations, administration and maintenance system 20 as shown in Fig. 1. The 
30 system 20 includes a PC or workstation 22, an element management server (EMS) 24. an interface in accordance with 
the invention 26, located between the workstation 22 and an object server 25. An application processor 28 is connected 
to the element management server 24, 

[0011] The workstation 22 Includes a web browser 30 which is the interface to the client and is a host for JAVA applets 
32 and web browser HTML 35 which is a hypertext markup language. 
35 [0012] The system 20 operates on a cluster computing environment, and leverages off-the-shelf technology to enable 
additional customers visible features, while extending to subsequent releases and other projects, with minimal in- 
creased cost. System 20 is provided through the web browser interface and a SNMP based element management 
platform. 

[001 3] A client executes applications via web pages at the workstation 22. The client makes requests for various 

40 views of the network status by making selections through the web browser 30. The web browser requests pages from 
the web server 28 which transmits HTML pages that contain instructions to load and run the appropriate JAVA applet 
32. One the applet starts, it communicates with the object server 25 through the interface 26 to perform initialization 
and to request initial configuration and status information that is appropriate for the current requested view. The JAVA 
applet 32 then registers with the object server 25 tor subsequent notifications of changes to configuration and status 

45 that it requires to keep the view up to date. The client may perform commands to request various maintenance oper- 
ations on the network element 28. These commands are converted into appropriate requests through the interface 26 
and perform operations on the object server 25. The commands are then translated into SNMP and are transmitted to 
the network element 28 through the SNMP library 33. Acknowledgements and command responses from the network 
element 28 are transmitted through the SNMP library 33, are converted to events by the object server 25 and transmitted 

so to originating JAVA applet 32 through the use of callbacks defined by the interface 26. 

[0014] In one embodiment of the invention, as shown in Fig. 3, client applications in JAVA applets 32 include an 
active alarm list browser, a system alarm survey and a network element detailed status display Client applications 
communication with the web server 28 via the interface 26 in accordance with the invention, to the element manager 
through a distributed object request architecture such as CORBA. The interface 26 provides a constant interface to all 

55 managed objects In the network, and hides the implementation details associated with the element manager platform. 
[0015] The interface 26 (EMAPI) is the definition of objects, attributes and operations that comprise the protocol used 
between client applications and the server to nnanage network elements. The EMAPI uses the industry standard COR- 
BA to provide distribution of the objects and their operations and to allow for the implementation of the client and server 
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to be in different programming languages and on different computer architectures. 

[001 6] The client interface to the server and the managed object attributes is described in the interface 26 and man- 
aged object notation provides a consistent model of all managed objects in the network, hiding the implementation 
details associated with the element manager platform from client applications, thus clients do not need to know the 

5 underlying protocol to the network elements. Managed objects specific logic is encapsulated within the managed object 
instead of scattered throughout various applications thus simplifying client application development. 
[0017] Each physical, selected non-physical and logical component in the network is modeled as a managed object, 
which the Server makes visible to distributed client applications through the facilities of the Common Object Request 
Broker Architecture (CORBA). EM clients need only be concerned about the attributes and operations defined for each 

10 application managed object, and not the details of network-level protocol and the server infrastructure required to 
support object services. 

EMAPI Object Definition 

75 [0018] Fig. 3 illustrates all of the interfaces visible to client applications which does not depict process or processor 
boundaries, which are made transparent by the client and server object request brokers (ORBs). Application services 
are provided through object interfaces formally defined in the CORBA Interface Definition Language (IDL). The IDL 
specification of the interfaces described in this document is provided in the Appendix A. 

[0019] The service objects resident on the server with which client applications will interact are shown in Fig. 4. 
20 [0020] Client applications which register for real-time status updates or notification of events, alarms or configuration 
changes must provide a reference to a local callback object which the server will use to propagate information asyn- 
chronously. The callback interfaces defined in the interface 26 are shown in Fig. 5. Classes which implement these 
interfaces must be defined and instantiated in client code. 

25 Data Representation 

[0021] There are several fundamental data types defined in the interface 26, which fall into one of the two categories 
shown in Fig. 6. 

30 Session Management 

[0022] Each EM client session is logically associated with a unique login-host combination. Multiple client applications 
may be associated with the same session, though only one need be registered for the session to be considered active. 
Session and application identifiers are assigned by the User Session Manager to track resources used by the client, 

35 and in future releases, to correlate client access permissions with operation requests. Applications may or may not 
cross process boundaries. For example, multiple Instances of the EMS Command Line Interface (CLI) application 
registered with the same login and host name will share the same session id, but each process is associated with a 
different application id. In the EMS Graphical User Interface, all application frames execute in the same process space 
(albeit in different Threads), yet each frame is associated with a distinct application id. Note that each client application 

40 is required to independently register a periodic heartbeat to validate for the Server that its associated resources are 
still needed. 

[0023] The UserSession service object provides the following interfaces: 

• start Application 

This method must be invoked for each client application initialization. 

• stopApplication 

A client invokes this method to notify the Server that a target application is terminating, and its associated 
resources should be released. 
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• stop 

This method may be used to deregister all applications associated with the same session identifier. 

• heartbeat 

[0024] This method must be invoked at least every UserSession: :HeartbeatPeriod seconds to avoid a timeout con- 
dition which, when delected by a Server audit, will result in the release of all resources utilized by an application. 
[0025] Refer to the description of interface UserSession in the attachment for additional details. 
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Managed Objects 

[0026] A managed object (MO) is an abstract representation of a physical or logical resource which may be managed 
by the EMS, such as a network element, maintenance unit or data link. The EM Server will implement one application- 

5 specific service object for each type of physical or logical resource to be managed. Each of these service objects 
defines a set of attributes which identify managed object properties, as well as the operations which may be performed 
on a specified managed object instance. (The decision to provide access to instance information through a single 
"service object" stems from the fact that current ORB implementations become unstable when managing very large 
numbers of remote references.) Fig. 7 depicts the relationship between Client, application-specific service object, and 

10 the internal Server representation of managed object instances. 

[0027] Each managed object service class is uniquely identified by a ClassCode. Each managed object instance is 
uniquely identified by an Instld. Any object instance in the system may be uniquely referenced by a managed object 
identifier (Oid), which is the combination of ClassCode and Instld. 

[0028] Managed object status information is reported by a service object as a sequence of attribute code-value pairs. 
15 Each attribute value is defined as a union of all of the interface 26 fundamental data types described in Fig. 6. 

[0029] Configuration information is reported as a sequence of ContigData structures, which are defined to contain: 

• network element instance id 
20 m managed object instance id 

• a managed object key list reported as a sequence of attribute-value pairs- when length is greater than 0, the key 
list specifies the associated logical identifiisrs (Logicallds) 

25 [0030] Each managed object service class must implement the MO interface, which defines the following configu- 
ration and status services: 

• viewConfig 

A client uses this method to obtain the current EMS view of the managed object configuration for a specified 
30 network element instance. Note that the reserved instance identifier Anylnslance may be used to obtain configu- 

ration information for all network elements. 

• notifyConfig 

A client may also register for an initial view of managed object configuration information and notification of 
35 subsequent changes via callback. The initial view is returned with a notification type CONFIGJNIT. Subsequent 

changes are reported with type CONFIG_CREATE or CONFIG„DELETE. 

• cancelNotify 

A client uses this method to cancel registration for managed object configuration notifications associated with 
40 a specified client application. 

• getPersistent 

A client may use this method to retrieve the set of attribute codes (SeqAttrCode) identifying all "persistent" 
data maintained by this service object. Values for persistent attributes of each managed object instance are stored 
45 and kept current irrespective of any client requests. 

• getAttrSpec 

A client may use this method to retrieve the name and codes of all attributes defined for a target service class 
(currently used for debugging only). 

so 

• getKeySpec 

A client may use this method to retrieve the set of codes (SeqAttrCode) identifying the attribute(s) which 
represents the logical identifier(s) of any instance of the target class. 

55 • viewStatus 

A client may invoke this method to obtain the EMS view of the current values for a specified set of persistent 
attributes for a specified managed object instance. 
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• get Status 

A client may use this method to register for a snapshot of current status information. This interface differs from 
the previous one in that the requested attribute list may specify any managed object attribute codes--not just those 
associated with persistent data, and the information is returned via client status callback (StatusCB). 

• startUpdate 

A client may also register for an initial view and notification of any updates to a list of selected attributes for a 
specified managed object instance. In this case, an initial view is reported via client callback with a notification 
type STATUS_INIT. Subsequent changes are reported with type STATUS_CHANGE. Note that managed object 
instance deletions are reported only through configuration change notification to avoid a potential flurry of client 
status callbacks when a network element is unequipped. 



• stopUpdate 

A client uses this method to cancel registration for managed object status updates associated with a specified 
client application. 



• getlnst 

A client may use this method to obtain a managed object instance identifier for a specified network element 
instance id and managed object key list. 

20 

[0031] Note that each method requires a client session application identifier (SessionAppId) to validate user access. 
In the case of configuration or status change notification registration, this identifier is also used to keep track of the 
additional server resources utilized while the client application is active. 

[0032] Refer to the description of interfaces MO, ConfigCB & StatusCB in the attachment for additional details. 
Network Element Level Managed Objects 

[0033] Each network-element level managed object must also implement the NEMO interface which defines addi- 
tional network-element level configuration services: 

30 

viewNEconfig 

[0034] A client may invoke this method to obtain the current EMS view of the network element configuration. 
55 • notifyNEconfig 

A client may also register for an initial view of network element-level managed object configuration information 
and notification of subsequent changes via callback. The initial view is returned with a notification type 
CONFIGJNIT. Subsequent changes are reported with type CONFIG_CREATE or CONFIG_DELETE. 

40 • cancelNEnotify 

A client application should use this method to cancel registration for network element managed object config- 
uration updates. 



• getNEinst 

A client may invoke this method to retrieve the NEMO instance identifier of the network element associated 
with a specified logical id. 

• getLogicalld 

A client may invoke this method to retrieve the logical identifier of the network element associated with a 
^0 specified NEMO instance id. 

• getContainment 

A client may invoke this method to obtain a sequence of containment information for the target NEMO, where 
each entry in the sequence contains the name, class code and CORBA reference to a contained service class 
55 object. 

[0035] Note that each method requires a client session application identifier to validate user access. In the case of 
configuration change notification registration, this identifier is also used to keep track of the additional server resources 
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utilized white the client application is active. 

[0036] Refer to the description of interfaces NEMO & NEconfigCB in the attachment for additional details. 
Descriptive Entity Objects 

[0037] Application objects of this type are defined to provide type and attribute information for abstract entities, such 
as data communicated between the EMS and network elements which are not part of a managed object description 
(e.g. SNMP trap definitions and command groups). Descriptive entity objects provide no implementation-they are de- 
fined in application-specific IDL and known by client applications at compile time. 

Event Distributor 



[0038] An event is reported as a combination of the following: 
15 1, A header, which contains information of most genera! interest: 

• Time of the event 

• Event category defined to be one of the following: 

20 

* Alarm Set 

* Alarm Clear 

25 * Command Acknowledgment 

* Command Response 

* Configuration Change 

30 

* Informational Message 

* Initialization 
35 * State Change 

• Network element object identifier 

• Network element alarm level-meaningful only for alarm set 

40 

• Maintenance unit object identifier (i1 applicable) 

• Maintenance unit alarm level-meaningful only for alarm set 

45 •A command identifier (Cmdld) defined as a user session id & command sequence number-meaningful 

only for command acknowledgment & response 

1. Event data defined as a sequence of structures which contain: 

50 • A ClassCode of a managed object, network element or descriptive entity 

• A sequence of attribute code-value pairs 

[0039] Client applications may request a copy of the event stream, as processed by the event distributor, filtered on 
55 information specified in the event header. Filter wildcards are implemented with "out-of-band" values: 

• Any Category 
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• Any Class 

• Any Instance 
5 • Any Alarm 

• Any Cmd 

[0040] The table in Fig. 8 summarizes which fitter criteria are valid for each event category: 
10 [0041] The event distributor processes filters by examining the specified category and AND'ing together valid criteria. 
Clients may simulate OR operations by registering multiple filters. 
[0042] The EvtDist service object implements the following client interfaces: 

• RegisterFilter 

A client uses this method to register an event filter A filter identifier is retumed. 

• CancelFilter 

A client invokes this method to remove a specified event filter, using the filter id returned from the associated 
registration. 

20 

[0043] Note that each method requires a client session application identifier to validate user access. 
[0044] Refer to the description of interfaces EvtDist & EventCB in the attachment for additional details. 

Alarm Manager 

25 

[0045] Alarm information is reported as a sequence of Alarm Data structures which contain: 

• The ClassCode of a managed object which defines a network-element specific alarm record. 

Note that in the first release of the EMS, only one network element active alarm table is defined (ApAc- 
30 tiveAlarms). 

• A sequence of alarm records, each of which contains an alarm instance identifier and sequence of attribute code- 
value pairs. 

Client applications may request a copy of all active alarms filtered on any combination of the folbwing: 

35 

• Network element 

• Maintenance unit 
^0 • Alarm level 

[0046] Similar to the interfaces provided by the event distributor, out-of-band values may be used to represent wild- 
cards. 

[0047] Since managed object instance infomnation may not be available at the time an alarm is reported, the actual 
45 alarm filter criteria are specified in terms of logical identifiers. Logical ids are integer values which represent the logical 
numbers of devices and interfaces (e.g. AP 4). The correlation between logical ids and managed object instance iden- 
tifiers is provided in the configuration information made available by each managed object service object, and through 
the utility method getlnst. Refer to the section on Managed Objects for additional details. 

[0048] The following AlarmManager client interfaces are written specifically for the Active Alarm List application: 

so 

• RequestAlarms 

A client invokes this method to register a filter for active alarms. 

• ChangeFilter 

^5 A client may invoke this method to change filter criteria. 

• RefreshAlarms 

A client may invoke this method to refresh the active alarm list. 
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• CancelAlarms 

A client should invoke this method to de-register a filter. 

[0049] All operations except for de-registration return all active alarms filtered on the specified criteria. Also, each 
5 of these nnethods requires a valid client session application identifier to validate user access, and to keep track of the 
additional server resources which may be utilized while each client is active. 
[0050] The following AlarmManager interface may be used by any client application (e.g. CLI): 

• opAlarm 

10 Through client implementations of event callbacks used to process command acknowledgements and re- 

sponses (the same EventCB reference may be used in both cases), this method returns either a list of all active 
alarms in the system or just those associated with a target network element. 

[0051] Refer to the description of interfaces AlarmManager, AlarmCB & EventCB in the attachment for additional 
is details. 

Exceptions 

[0052] Exceptions are used for consistent and structured error handling in both the EM Server and Client. 
20 [0053] The CORBA specification defines many system exceptions: • 

• BAD_PARAM 

• INV_OBJREF 

25 

• NO_PERMISSION 

• BAD_OPERATION 
30 • OBJ_ADAPTER 

• 

[0054] Refer to "The Common Object Request Broker Architecture and Specification" for an exhaustive list of mne- 
35 monies and the associated exception descriptions. 

[0055] Vendor-specific object request broker exceptions are also defined (using the Minor identifier of the SystemEx- 
ception): 

• NO_IT_DAEMON_PORT 

40 

• LICENCE_EXPIRED 
• 

45 [0056] Currently, the EMS uses lona's Orbix product. Refer to the "Orbix 2.3c Reference Guide" for an exhaustive 
list of mnemonics and the associated exception descriptions. 

[0057] In most cases, exceptions will be treated as fatal errors by Client code resulting in application termination. 
[0058] An interface 26-specific exception is also defined as an Exception Code containing one of the following values 
shown in Fig. 9. 

so 
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APPENDIX A- Emapi.idl 

#xfndef _EMAPI__IDL 
^ #define _EMAPI_IDL 

// 

// File: Emapi.idl 
// 

10 // Description: CORBA IDL file for the Element Manager API. All client 

// visible interfaces that are common to all applications of the 

EMS 

// are described here . 

// 

15 ^ . 

// interfaces which are referenced before they are defined 

interface ConfigCB; 

interface StatusCB; 

interface NEconfigCB; 

interface EventCB; 

interface AlarmCB; 

// some of the more commonly used ASN.l standard types 
typedef booliean AsnlBoolean; 
typedef long Asnllnteger ; 

25 typedef unsigned long AsnlUInteger ; 

typedef sequence<octet> AsnlOctet; 
typedef unsigned long ' AsnlTimeticks ; 

typedef unsigned long AsnlGauge; 
typedef unsigned long AsnlCounter; 
typedef octet AsnllpAddress ( 4 ] ; 

typedef octet AsnlNull; 
typedef sequence<unsigned long> AsnlOid; 



30 



// logical identif ier--one or more attributes of this type may be 
35 defined 

// for any managed object to provide a logical identity (e.g. 
application 

// processor number, RCS number) 

typedef Asnllnteger Logicalld; 

typedef sequence<LogicalId> SeqLogicalld; 

40 

// definition of an object identifier 
typedef long ClassCode; 
typedef unsigned long Instid; 

45 struct Oid { 

ClassCode classid; 
Ins.tid instid; 

) ; 



50 



// reserved class id 

const ClassCode AnyClass = -1; 



// reserved instance id's 

const Instid Nulllnstance = 0; 

const Instid Anylnstance = 1; 

55 const InstXd MaxRsvdInst = 1; 
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// instance id associated with singleton objects (e.g. Sys tern) --not e 
that 

// this is the first id normally assigned 

const Instid Singletonlnst = MaxRsvdInst + 1; 
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// reserved logical id 

const Logicalld AnyLogicalld = -1; 

// application identifier 
typedef long Appid; 

// reserved application id's 

const AppId NullAppId = -1; 

const AppId AnyAppId = -2; 

// application/session identifier 
struct SessionAppId { 

Instid session; 
AppId app; 

1 ; 

// maximum number of applications active per single user session 
const short MaxSessionApps = 10; 

// command identifier 
25 typedef long CmdSeqNo; 



20 



If reserved command sequence number 

const CmdSeqNo AnyCmd = -I; 

const CmdSeqNo InvalidCrad = -1; 

struct Cmdid { 

Instid session; 

CmdSeqNo seqNo ; 

1; 



// element manager base application programming interface exception 
35 codes 

enum Emapi Except ionCode { 

Eavi^I NVALI D_U S ER , 

EM_UNKNOWN_HOST , 

EM_T0O_MANY USER_SESSIONS , 

EM_TO 0_MAN Y^A P P L I CAT IONS, 

EM^XNVALI D_S ES S ION_I D , 

EM^INVALI D_APP_I D , 

EM_INVALID_INST_ID, 

em_invali d_ne'_i d , 
em_invalid_mo_i d, 
45 em inyalid_attr_code, 

em[]no_matching_inst, 

EM_INVALI D_FI LTER , 
EM_INVALID_FILTER_ID, 
EM_NE_IS01ATED, 
EM_INTERNAL_ERROR, 
EM__INVALID_0PERATION, 
EM_ACCESS_DENIED, 
EM_VERS I ON_MI SMATCH , 
EM_LO ST_RESOURCE , 
EM_INVALI D_KEY , 
55 EM INVALID CATEGORY 
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I ; 



10 



IS 



20 



// element manager exception 

exception EmapiException { EmapiExceptionCode errCode; }; 
// Access permissions: 

// For now, permission is granted on a network element basis: 

/ / on any kind of access 

// on status information access 

// on maintenance operation access 

// The network element basis can be: 

/ / on any network element 

// Oid: { AnyCldss, Anylnstance) 

// on any instance of a particular network element type 

// Oid: ( <class>, Anylnstance] 

// on a specific instance of a particular network element 

type 

// Oid: ( <class>, <instance>} 

// Kinds of Access (set to be manageable by using a bit map/mask) : 
typedef Asnllnteger AccessType; 



25 



30 



const AccessType 
const AccessType 
const AccessType 
const AccessType 
//const AccessType 
//const AccessType 
//const AccessType 



AnyAccess = -1; 
NoAccess = 0; 
StatusAccess = 1; 
OperationAccess = 2; 
NextAccess = 4; 
AfterThat = 8 
AfterThat = 16 



// 



.and so on, in powers of 2 



// Access Permission structure: 



// 
// 
// 

access 



accessible TRUE or FALSE for this type of access 

accessType type of access 

oid network element involved in this type of 



35 



40 



45 



SO 



Struct AccessPermission { 

boolean accessible; 
AccessType accessType; 
Oid oid; 

) ; 

// Application registratioti results in the client's receiving a 
sequence of 

// AccessPermission blocks. 



typedef sequence<AccessPermission> 



SeqAccess Permission; 



struct AccessPermissionList { 
Ses si onApp Id 
SeqAccess Permission 

} ; 

// user session 
interface UserSession { 

// Null Session 

const Instld 



sessionAppId; 
SeqAccess Permission; 



Nullsession 



= 0; 
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// maximum number of sessions per system 

const short MaxUser Sessions = 32; 

^ // heartbeat period in seconds (Applications should use this 

value to 

// time their heartbeats with the server.) 

const long Heartbeat Period = 5; 

// client application registration: must be called once per 
10 // application. 

// 

// INPUTS: 

// applicationName : determined by client application 

// host: name of host on which client is running 

// user: login id 

// passwd: user's password 

// RETURNS: 

// unique id for this session's application 

// plus a sequence of Access Permission blocks 

// showing what is accessible from this application 

// NOTE: The client's responsibility to delete the returned 

pointer 

// 

// THROWS: 

/ / EM_TOO_MAN Y_S E S S I ON S 

/ / EM_TOO_MANY_7VP PLI CATIONS 

AccessPermissionList s tartApplication { 
in string host, 
in string user, 
in string passwd, 
in string applicationName) 
30 raises ( Emapi Exception) ; 

// client deregistration — entire session 

// 

// INPUT: a session application id 

// 

// THROWS: 
// EM_INVALID_SESSION__rD 

void stop (in Instid sessionid) raises (EmapiException) ; 
// client deregistration — single application 

40 // 

// INPUT: a session application id 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_I^AAALID_APPLICATION_ID 
.void stopApplication ( in SessionAppId id) 
raises (EmapiException) ; 



20 



2S 



35 



45 



// client heartbeat 

// 

so // INPUT: session application id 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 
// EM_INTERNAL_ERROR 
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void heartbeatdn SessioixAppId id) raises ( EmapiException ) ; 



10 



IS 



20 



// 

// Managed Object definition. The Managed Object (MO) describes 
definitions 

// and operations that are common to all application specific managed 

// objects in the system, 

// 

interface MO { 

// All attributes of an MO are identified by integer constant 
// codes called AttrCodes. 

typedef long AttrCode; 

const AttrCode NullAttrCode = -1; 

// 

/ / The following attribute codes are reserved and are used 
//by the MO implementation. Clients should always use the 
// attribute codes found in the application specific managed 
// object definition (e.g. ApModule.idl) and not these. 
// 

const AttrCode moInstanceCode - 0; 

const AttrCode nelnstanceCode = 1; 

const AttrCode LastReservedCode= 1; 



25 



30 



35 



40 



// clients register for updates by specifying a sequence of 
/ / attribute codes 

typedef sequence<AttrCode> SeqAttrCode; 

/ / The atrribute value is a discriminated union of scalars 
/ / All basic types currently supported by the EMS are 
des cribed 



// here, 
typedef long 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 



AttrType; 

Vallnstid 

ValAsnlBoolean 

ValAsnllnteger 

ValAsnlUInteger 

ValAsnlOctet 

Va lAsnlTime ticks 

ValAsnlGauge 

ValAsnl Counter 

ValAsnllpAddress 

ValAsnlNull 

ValAsnlOid 



const AttrType' ValLogicalld 



1; 

2; 

3; 

4; 

5; 

6; 

7; 

8; 

9; 

10; 

11; 

12; 



45 



SO 



// 
// 
// 
// 

union AttrValue switch (AttrType) { 



The following union defines all possible attribute types 
in the EMS. 



55 



case Vallnstid: 
case ValAsnlBoolean: 
case ValAsnllnteger: 
case ValAsnlUInteger: 
case ValAsnlOctet: 
case ValAsnlTimeticks : 
case ValAsnlGauge: 



Instid 

AsnlBoolean 

Asnllnteger 

AsnlUInteger 

AsnlOctet 

AsnlTimeticks 

As n I Gauge 



instid; 
asnlBoolean; 
asnllnteger; 
asnlUInteger ; 
asnlOctet ; 
asnlTimeticks ; 
asnlGauge; 
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case ValAsnlCounter : AsnlCounter asnlCounter; 
case ValAsnllpAddress : AsnllpAddres s asnllpAddress ; 
case ValAsnlNull: AsnlMull asnlNull; 

case ValAsnlOid: AsnlOid asnlOid; 

case ValLogicalld: Logicalld logicalld; 

} ; 

// 

// each set of updates on a managed object is delivered 
// as a sequence of attribute- value pairs ( SeqAttrCodeValue ) . 
// 

struct AttrCodeValue { 

AttrCode code; 
Att rvalue value; 

) ; 

15 typedef sequence<AttrCodeValue> SeqAttrCodeValue; 

// 

// The getAttrlnfo method of the MO returns a sequence of 
// information that describes each available attribute. 

// 

struct Attrlnfo { 

AttrCode code; 

AttrType type; // note: currently not 

populated 

AsnlOctet name; 

25 } ; 

typedef sequence<AttrInf o> SeqAttrlnfo; 

// 

// Config update notifications (via the deliverConf ig method 
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30 
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SB 



in Che 



// ConfigCB) can take two forms. 

// 1) One or more managed object instances have been 

created. 

// (CONFIG_CREATE) . 

// 2) One or more managed object instances have been 

deleted 

// (CONFIG_DELETE) . 

// 

enum Conf igNotif yType { 

CONFIG_CREATE, // a new MO instance has been created 
CONFIG_DELETE // an existing MO instance has been 
deleted. 

} ; 

// 

45 // Status update notifications (via the deliverStatus method 



in the- 

either 
from 

change 



// StatusCB) can take two forms. 

// 1) An initial update (STATUS^INIT) that is returned 

// as a result of a getStatus or as the initial status 

// a startUpdate request. 

// 2) An inremental update ( STATU S_CHANGE) representing a 
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15 



30 



40 



SO 



// to one or more of the attributes that the client 

registered for. 
// 

enuin StatusNotif yType { 

STATUS_INIT, // represents initial status update of 



all 

startUpdatel 
update 

}; 



// requested attributes {e.g. 

STATUS_CHANGE // represents an incremental status 

// (contains only attributes that have 

// changed) . 



// 

// each ccnfig update notification will be delivered as a 
sequence of: 

// network element instance id 

// managed object key list (sequence of attr- 

value pairs) 

// managed object instance id 

struct ConfigData { 

Instid nelnst; 

SeqAttrCodeValue keyList; 

Instid molnst; 

25 ); 

typedef sequence<Conf igData> SeqConf igData; 
// 

// viewConfigO - obtain EMS view of the current managed 

object 

// configuration for a specified network element 

instance. 

// The special value Anylnstance may be used to obtain 

// configuration information for all network elements 

35 known 

// to the EMS, 

// INPUTS: 

// sessionAppId - client session/ application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// nelnst - specific NE instance identifier, or 

Anylnstance 

// to get config for all ME instances. 

45 // RETURNS: 

_ // A sequence of configuration information (sequence 

length 

// is proportional to the number of configured MO 

instances ) . 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVAI-ID_APP_ID 
// EM_INVALID_INST_ID 

55 // 
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SeqConf igData viewConf ig ( in Ses sionAppId sessionAppId, 

in Instid nelnst) 
raises ( Emapi Except i on) ; 

' // 

// notif yConf ig ( ) - Client registration for managed object 
// configuration information for specified network 

element 

// instance (or the Anylnstance to register for 

10 notifications 

// on all network element instances) . The current 

snapshot 

// of configuration is returned (like viewConfig) and all 

// subsequent configuration changes result in an 

invocation of 

// the specified callback. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

20 // used to validate client permission to 

perform 

// the operation. 

// nelnst - specific NE instance identifier, or 

Anylnstance 

// to get config for all NE instances. 

// callback - client callback (implements the 

Conf igCB 

// interface) that will be invoked for 

all 

// config changes. 

30 // RETURNS: 

// A sequence of configuration information (sequence 

length 

// is proportional to the number of configured MO 

instances ) . 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

/ / EM_I NV7>lLI D_S E S S I 0N_I D 

// EM_INVALrD_APP_ID 

// EM_INVALID_INST_ID 
40 // 

SeqConf igData noti'f yConf ig { in SessionAppId sessionAppId, 

in InstId nelnst, 
in ConfigCB callback) 
raises (EmapiEKception) ; 

45 

- // cancelNotify { ) - Cancel all requests for configuration 

change 

// notifications associated with the specified client 

application. 
so // 

// INPUTS: 

// sessionAppId - client session/application identifier* 

This is 

// used to validate client permission to 

perform 

55 ^ 
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2S 



30 



35 



// the operation. 

// RETURNS: 
/ / void 
// 

// THROWS: 

// EM_IlW7U.ID_SESSION_ID 
// EM INVALID APP ID 

// " ~ ~ 

void cancelNotif y (in SessionAppId sessionAppId) 
raises ( Emapi Except! on ) ; 



// 

// getPersistent { ) - Obtain the attribute codes for all 
persistent 

75 // attributes maintained by this managed object. 

Persistent 

// attributes are those that the EMS keeps the current 

value 

// regardless of client registrations. Other attributes 

are 

// polled for only when a client makes a request or 

registers 

// for update notifications. 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

/ / used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// a sequence of attribute codes representing the 

persistent 

// attributes. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

/ / EM_I NVALI D_5 ES S ION_I D 

// EM_INVALID APP ID 

// ~ " 

SeqAttrCode getPersistent ( in SessionAppId sessionAppId) 

raises (EmapiException) ; 

40 // 

// getAttrSpec ( ) - Return identification of attributes that 

are 

// defined for the specific managed object instance. A 

sequence 

45 containing the attribute name (an OCTET representing 

the 

// ASCII string name) and the associated attribute code 

// is returned . 

// 

// INPUTS: 

// sessionAppId - client session/ application identifier. 

This is 

/ / used to validate client permission to 

perform 

// the operation. 

55 // RETURNS: 
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// A sequence of attribute info representing the 

attribute names and codes. 
// CALLER MUST DELETE RETURNED MEMORY. 

// 

^ // THROWS: 

/ / EM_I NVALI D_S ESS I ON_ I D 

// EM_INVALID_APP_ID 

// 

SeqAttrlnfo getAttrSpec { in SessionAppId sessionAppId) 

raises (EmapiException) ; 

// 

// getKeySpec() - Return identification of key attributes. A 

sequence 

// of attribute codes representing the keys is returned. 

Note 

// that the sequence will be in the order defined in the 

// MOview. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// A sequence of attribute codes. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_I^arALID_SESSION_ID 
30 // EM_INVALID_APP_ID 

// 

SeqAttrCode getKeySpec (in SessionAppId sessionAppId) 

raises (Elmapi Except ion) ; 



20 
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// 

// viewStatus() - obtain EMS "view" of the values of the 
specified 

// persistent attributes. 

// INPUTS: 

// sessioni^pld - client session/application identifier. 

40 This is 

// used to validate client permission to 

perform 

// the operation. 

// instid ' - MO instance. This specifies the MO 



45 



whose 



be 



// attributes are to be examined. 

'-// attrList - sequence of attribute codes that are to 



// viewed. 
// RETURNS: 

SO // a sequence of attribute code/value pairs representing 



the 



// current view of the attribute values. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 
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// THROWS: 

// EM_INVALID_SESSIOM_ID 
/ / EM_INVALI D_APP_I D 

/ / EM_INVALr D_INST_I D 

^ // EM_INVALID_MO_ID 

// EM_INVAI.ID_ATTR_CODE 
// 

SeqAttrCodeValue viewStatus ( in SessionAppId sessionAppId, 

in Instid instid, 
10 in SeqAttrCode attrList) 

raises (EmapiException) ; 

// 

// getStatus() - request for a snapshot of current status 
// information. This differs from viewStatus in that 

attrList 

// may specify any managed object attribute codes, and 

the 

// information is returned via client callback. The 

callback is 

20 // used because the request may require a get request to 

the 

// network element. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 
perform 



IS 



25 



30 



35 



40 



45 



be 



// 




used to validate client permission 


// 




the operation. 


// 


instXd 


- MO instance. This specifies the MO 






attributes are to be examined. 


// 


attrList 


- sequence of attribute codes that are 


// 




retrieved. 


// 


RETURNS : 




// 


void 




// 






// 


THROWS : 




// 


EM INVALID 


SESSION ID 


// 


EM invalid" 


APP ID 


// 


EM invalid' 


INST ID 


// 


EM INVTVLID" 


'mO ID 


// 


EM INV/SlLID" 


ATTR CODE 


// 






void getStatus^in Session^pld sessionAppId, 



in InstId instId, 
in SeqAttrCode attrList, 
in Statuses callback) 
raises (EmapiException) ; 

// 

// startUpdate ( ) - client registration for notifications of 
SO // any updates to the values of the specified set of 

attributes . 

// An initial snapshot of all requested attributes is 

// delivered first ( type=STATUS_INIT) followed by 

notifications 

55 
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// of only those attributes that have changed 

{ type=STATUS_CHANGE) 

// Note that this method may result in polling to the 

^ network 

// element, but only if the attributes are not persistent 

and 

// no other clients have issued a startUpdate for the 

attributes (only a single poll is used for all 
registered 
10 // clients). 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission co 

perform 

// the operation. 

// instid - MO instance. This specifies the MO 

whose attributes are to be examined. 
// attrList - sequence of attribute codes that are to 



15 



20 



be 



// monitored. 
// RETURNS: 
// void 
// 

2s // THROWS: 

// EM_INVALrD_SESSION_XD 

// EM__INVALXD_APP_ID 

// EM_INVALID_INST_ID 

// EM_INVALlD_MO_ID 

// EM__INVALID_ATTR_CODE 
30 // 

void StartUpdate (in SessionAppId sessionAppId, 
in Instid instid, 
in SeqAttrCode attrList, 
in Statuses callback) 
3^ raises (EmapiException) ; 

// 

// stopUpdate() - client deregistration for status updates. 

all monitoring activity associated with the specified 
application. Note that the client may have issued a 
of staj;tUpdate requests for different instances, but 
single call to stopUpdate will cancel all of those 

PUTS : 

sessionAppId - client session/ application identifier. 

used to validate client permission to 
the operation. 

:turns : 

void 





Cancel 








// 


40 


client 








// 




number 








// 




this 




45 




// 




requests 








// 






// 






// 




This is 




SO 




// 




perform 








// 






// 






// 


ss 




// 
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II THROWS: 

// EM_INVALID_SESSION_ID 
// EM_IhrVALID_APP_ID 

5 

void s topUpdat e ( in SessionAppId sessionAppId) 
raises ( EinapiException) ; 

// 

// getlnsti) - return the instance identifier associated with 

the 

70 // specified keys. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// nelnst - the network element instance identifier 

of the 

/ / NE that contains the managed object 

20 instance 

// specified by the keys. 

// RETURNS: 

// the Instid of the managed object, or Nulllnstance if 

not found, 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 
// EM_INVALID__INST_ID 
// 

20 Instid getlnst(in SessionAppId sessionAppId, 

in Instid nelnst, 
in SeqAttrCode Value keyValues ) 

raises (EmapiException) ; 

1 ; 

55 

// 

// client callback for managed object configuration reporting 

// 

interface ConfigCB ( 

oneway void deliverConf ig (in ClassCode class Id^ 

in MO: : Conf igNotif yType type, 
in MO: : SeqConf igData config) ; 

) ; 



45 



// 

// client callback for managed object status reporting 
// 

interface StatusCB { 

oneway void deliverStatus (in Oid oid, 

in MO: :StatusNotifyType type, 
in MO: : SeqAttrCodeValue 

attrValList) ; 
} ; 

// network element level managed object 
interface NEMO : MO ( 
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// attribute code reserved for boolean network element 

// isolation indication. 

const AttrCode IsolatedCode = 1; 

s // 

// each network level configuration update notification is 
delivered 

// as a sequence of: 

// network element instance id 

10 // network element logical id 

struct NEconfigData { 

Instid instld; 

Logicalld logicalld; 

I ; 

typedef 5equence<NEconf igData> SeqNEconf igData ; 
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// 

// Sequence of containment information describing all 

// contained managed objects. 

// 

struct Containmentinf o { 

ClassCode classCode; 
MO moRef; 
AsnlOctet name; 



typedef sequence<Cont:ainmentInf o> SeqContainmentlnf o ; 



// 

// viewNEconf ig ( ) - obtain EMS view of current network element 
/ / configuration 

30 // 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// Sequence of network element configuration information, 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

40 // THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 
// 

SeqNEconf igData viewNEconf ig ( in SessionAppId sessionAppId) 

raises (EmapiException) ; 



ss 



■•// • 

// notif yNEconf ig ( ) - client registration for network level 
// managed object configuration. An initial snapshot of 

// the network element level configuration is returned. 

// All subsequent changes to the network element 

configuration are delivered via the specified callback. 

// 

// INPUTS: 

// sessionAppId - client session/ application identifier. 

This is 
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// used to validate client permission to 

perform 

// the operation. 

// callback - callback object that is to receive 

delivery 

// of changes to configuration. 

// RETURNS: 

// Sequence of network element configuration information. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

/ / EM_I NVALI D_S ES S I ON_I D 

// EM INVALID_APP_ID 

// 

15 SeqNEconf xgData notif yNEconf ig (in SessionAppId sessionAppId, 

in NEconfigCB callback) 
raises ( EmapiException) ; 



10 



20 



// 

// cancelNEnotif y ( ) - cancel request for NE configuration 

change notifications 
// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

25 // used to validate client permission to 

perforin 

// the operation. 

// RETURNS: 
// void 

// THROWS: 

// EM_rNVALID_SESSION_ID 
// EM_INVALID_APP__ID 

// 

void cancelNEnotif y ( in SessionAppId sessionAppId) 
35 raises (EmapiException) ; 

// 

// getNEInst ( ) - return the network element instajice 
identifier 

// associated with the specified NE logical identifier. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

45 perform 

_// the operation. 

// logicalld - the logical identifier (integer) of 

the network element. 

// RETURNS: 

// the InstId of the network element instance, or 

Nulllns tance 

// if not found. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
55 //EM INVALID APP ID 



40 



SO 
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// 

Instid getNEinstdn SessionAppId sessicnAppId, 
in Logicaild iogicalld) 
^ raises ( Err»api Ex crept ion ) ; 

// 

// getLogicalld ( ) - return the NE logical identifier 

// associated with the specified instance identifier. 

// 

10 // INPUTS: 

// nelnst - the instance identifier of the network 

element . 

// 

// RETURNS: 

// the logical identifier of the network element 

instance, 

// or 0 if not found. 

// 

Asnllnteger getLogicalld (in Instid nelnst); 

20 // 

// getContainment ( ) - return sequence with containment 
information 

// for this network element. The sequence returned 

contains 

25 // the name, class code and a pointer to the associated 

service 

// class object. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

^0 This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// a sequence of containment information describing the 

contained 

// managed objects. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 
// 

SeqContainmentX^fo getContainment (in SessionAppId 
sessionAppId) 

^5 raises ( EmapiException) ; 

}; 

// client callback for network element level managed object 
configuration 
// reporting 
interface NEconfigCB ( 

oneway void deliverNEconf ig { in ClassCode classid, 

in NEMO: : Conf igNoti fyType type, 
in NEMO: : SeqNEconf igData conf ig) ; 

55 } ; . 
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// typedefs for acknowledgement value & alarm level 
typedef Asnllnteger AckValue; 
5 typedef Asnllnteger AlarmLevel; 

//no alarm filtering conjunctions are permitted, but we do allow a 
single 

// filter to extract all alarmed notifications by defining an "out-of- 
band" 

// alarm level 

const AlarmLevel AnyAlarm = -1; 

// typedef for event data st ructure--note that instance information 
may no 

75 // longer be valid when an event is processed^ so key information 

should 

// always be available in the attribute-value list 
struct EventData { 

ClassCode classCode; 

MO: : SeqAtt r Code Value seqVal; 

typedef sequence<EventData> SeqEventData ; 
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// event distributor interface description 
interface EvtDist { 

// time of event as reported by EMS 

typedef long EventTime; 

// categories of events 
enum Category { 

ANY_EVENT, 

AIiARM_CLEAR, 

ALARM_SET, 

CMD_ACK, 

CMD_RESP, 

CONFIG_CHANGE, 

INFO^MSG, 

INIT_MSG, 

STATE_CHANGE, 

NUM_CATEGORI ES 

} ; 

// event header (not all members valid for all categories) 
struct Header { 

EventTime 

Category 

Old 

AlarmLevel 
Old 

AlarmLevel 
Cmdid 



eventTime; 

category; 

networkElemId; 

n e two r k El emAlm ; 

maintUnitId; 

maintUnitldAlm; 

cmdId; 



} ; 



so 
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// event filter (not all members valid for all categories) 
struct Filter { 

Category category; 

Oid networkElemId; 

AlarmLevel n e two rkEl emAlm; 

Oid maintUnitld; 
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AlarmLevel maintUni t IdAlm; 

Cmdid cmdld; 

} ; 

^ // cookie for client registration/deregis tration 

typedef long Filterld; 

// client registration for events 
// 

10 II INPUTS: 

// id: SesionAppId associated with the filter 

// filter: EvtDist :: Filter that specifies filter 

criteria 

// callback: EventCB that defines deli verEvent ( ) 

// operation that will be called when an 

// incoming event matches the filter 

// RETURNS: 

// unique Filterld for this filter 

// 

// THROWS: 

/ / EM_I NVAI* I D_S ES S I ON_I D 

// EM_INVALID_APP_ID 
/ / EM_INVALID_CATEGORY 

Filterld regis terFilter { in SessionAppId id, 

in Filter filter, 
in EventCB callback) 
raises ( Emapi Except ion ) ; 
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II client filter deregis tration 

// 

// INPUTS: 

30 I / id: SesionAppId associated with the filter 

// to be cancelled 

// filterld: Filterld of the filter to be cancelled 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 
/ / EM_INVALI D_FI LTER_I D 

void cancelFilter (in SessionAppId id, 

in Filterld filterld) 
raises (EmapiException) ; 

// client callback for event notification 
interface EventCB { * ^ 

45 // deliverEvent ( ) is called by event distribution 

// software whenever an incoming event matches 
*// a registered filter. 
// 

// INPUTS: 

// header: EvtDist: :Header associated with the 

^0 // incoming event 

// data: SeqEventData {sequence of event data) 

// associated with the incoming 

// event 
// 

55 oneway void deliverEvent (in EvtDist: : Header header. 
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in SeqEventData data) ; 

// This empty operation is called during event filter 
^ // auditing to determine wnether or not the associated 

// session/application is still active. If it has 
// terminated, a CORBA: : SystemException will be thrown 
// and subsequently caught, indicating that the associated 
// filter should be removed from the filter queue, 

10 oneway void check () ; 

} ; 

// typedefs for alarm data structures 
struct AlarmKecord { 
^5 Instid instid; // unique per alarm 

definition 

MO: : SeqAttrCodeValue attrValList; 

I; 

typedef sequence<AlarmRecord> SeqAlarmRecord; 

20 struct AlarmData { 

ClassCode alarmDef; 

SeqAlarmRecord alarmRecords ; 

} ; 

typedef sequence<AlarmData> SeqAlarmData; 
// alarm notification type 

enum AlarmNotif yType { ALARM_SET, ALARM^CLEAR } ; 

// active alarm manager interface description 
interface AlarmManager ( 

// active alarm filter — note that logical ids are specified 

since 

// instance information may not be available at the time 
alarms are 

// reported 
struct AJLarmFilter { 

ClassCode alarmDef; 
Logicalld networkElemId; 
ClassCode maintUnitClass ; 

SeqLogicalld maintUnitId; 
AlarmLevel alarmLevel; 

40 ); 

// client registration for active alarms — both initial data & 

update 

// notifications (note that only one alarm filter can be 
registered 

// with the alarm manager by each client application) 
SeqAlarmData requestAlarms (in SessionAppId sessionAppId, 

in AlarmFilter filter, 
in AlarmCB callback) 
raises (EmapiException) ; 

so 

// request to change filter criteria (note that only one alarn 

filter 

// can be registered with the alarm manager by each client 
application) 

55 SeqAlarmData changeFii ter ( in SessionAppId sessionAppId, 
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25 



35 
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45 



SO 



alarms 
alarm 



to the 



in AlarmFilter filter) 
raises ( EmapiException ) ; 

// request to refresh alarm lis t--returns snapshot of current 

// (note that only one alarm filter can be registered with the 

// manager by each client application) 

SeqAlarmData re f reshAlarms ( in SessionAppId sessionAppId) 

raises (EmapiException) ; 

// client deregistration — cancel alarm set & clear forwarding 



// specified client application (note that only one alarm 
filter can 

// be registered with the alarm manager By each client 
application) 

void cancelAlarms ( in SessionAppId session^pld) 
raises (EmapiException) ; 

// request for a list of all alarms in the entire system or 
associated 

// with the indicated network element — supports the EMS 
version of the 

// "OP: ALARM" technician command 

CmdSeqNo opAlarmCin SessionAppId sessionAppId, 
in ClassCode alarmDef, 
in Logicalld networkElemId, 
in EventCB ackCB, 
in EventCB cmdRespCB) 
raises (EmapiException) ; 

) ; 

// client callback for active alarm notification 
interface AlarmCB ( 

oneway void de liver Ala rms { in AlarmNotif yType type, 

in AlarmData data); 

) ; 



// active alarms service object interface, derived from managed object 
// interface — note that no filtering of active alarms can be specified 
interface ActiveAlarms : MO { 

// system client (e.g.. Active Alarm Manager) registration for 
// active alarms — both initial data and update notifications 
SeqAlarmRecord getAlarms (in SessionAppId sessionAppId, 

in AlarmCB callback) 
raises (EmapiException) ; 

// system client (e.g., Active Alarm Manager) deregistration — 
_.// cancel active alarms update notifications 

void cancelAlarms ( in SessionAppId sessionAppId) 
raises (EmapiException) ; 
1 ; 

ttendif // _EMAPI_IDL 
// EOF // 
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APPENDIX B-GLOSSARY 

Alarm The description of an alarmed notification. 

Attribute 
Attribute Code 



Class Code 

Configuration 
Information 



so 



CORBA 
EMAPI 
EMS 
Event 

Instance Identifier 
Interface Operation 

Logical Identifier 

Managed Object 
ORB 

Object Identifier 



A property of a managed object (e.g. alarm state). 

An integer value which uniquely identifies an attribute of a given managed 
object. 

An integer value which uniquely identifies a managed object class. 

Generic term which has one of two meanings depending on its context: 

With respect to a managed object class, this term applies to the identification 
of all instances of the class, either for a specific network element or for all 
network elements in the system. 

With respect to a managed object instance^ this term may apply to one or 
more attributes which are associated with database values^ such as the 
primary/alternate role of a duplex component. 

Common Object Request Broker Architecture 

Element Management Application Programming Interface 

Element Management System 

The description of a spontaneous occurrence, such as alarm notification, 
command acknowledgment or configuration change. 

An integer value which uniquely identifies an instance of a given managed 
object. 

Generic term for distributed service request. The target method may be 
defined in the Element Management Application Programming Interface (e.g. 
status registr^on) or in an application-specific derivation of a managed 
object (e.g. conmiand execution). 

An integer value which represents the logical number of a device or interface 
(e.g. AP 4), Note that there is no direct correlation between a logical id and 
instance id. 

An abstract representation of a physical or logical resource which may be 
managed by the EMS (e.g. network element, maintenance unit, data link). 

Object Request Broker 

The combination of managed object class code and instance identifier which 
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uniquely identifies any managed object instance.in the system. 



10 



Persistent Attribute 

Sen/ice Object 
Session 



Information stored and kept current irrespective of any client request (e g. 
maintenance state). 

Any EM Server object which provides services to client applications 

Each client must establish a session at initialization— for which a unique 
session identifier is assigned— that will be used to validate access permissions, 
to correlate client requests and to keep track of Server resources utilized in 
behalf of any applications associated with the session. 



75 



Status Information Current attribute values for a managed object instance. 



Claims 

20 

1. In a network having a controllable network element, a method for controlling the network element from a remote 
work station connectable to the network, comprising the steps of: 

registering the network element for attributes to be tracked; and 

2S 

polling for attributes associated with the network element only if the client requests the monitoring of the net- 
work element. 

2. The method of claim 1 wherein the polling is performed by the server 

30 

3. The method of claim 1 including the step of reporting changes in attributes when the client requests notification of 
changes in attributes. 

4. The method of claim 1 , including the steps of 

35 

polling for the attributes for a plurality of clients, and 

reporting changes in the attributes to one of the plurality of clients requesting notification of changes in the 
attributes- 

40 

5. The method of claim 4 wherein the step of polling includes the step of polling once for a plurality of clients that 
registers for the same attributes. 

6. The method of claim 5 including reporting asynchronously changes in the attributes to a plurality of clients. 

45 

7. The method of claim 1 wherein the step of polling is performed in a single polling cycle when multiple clients have 
registered for the same attributes. 

8. The methcxJ of claim 7 including the steps of 

so 

running an object oriented program at the remote work station to control an object associated with the con- 
trollable network element; 

translating interface operations generated by the work station during the running of the object oriented program 
55 to corresponding translated interface operations in an object oriented language associated with the object 

being controlled; and 

connecting the corresponding translated interface operations through the network to an object server to control 
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the object associated with the network element in accordance with the translated interface operations. 

The nnethod of claim 8 in which step of translating includes the steps of 

automatically determining which of a plurality ot different object oriented languages is the object oriented lan- 
guage of the object being controlled, and 

generating translated interface operations corresponding to the interface operations from the remote worksta- 
tion to the object server in accordance with the language of the object being controlled as has been automat- 
ic' ically determined. 

10. The method of claim 8 in which the object oriented program run at the remote work station is a JAVA program. 

11. The method of claim 8 in which the network element is located at a node of the network and the step of translating 
^5 includes the step of 

receiving the interface operations through a communication link ot the network at a node separate from the 
node of the network element. 

translating the interface operation through the network communication link into the corresponding translated 
interface operations by converting the received interface operations into IPC and TCP/IP requests. 

12. The method of claim 11 in which the step ot connecting includes the step of transmitting the IPC and TCP/IP 
requests to the object server 

1 3. The method of claim 1 2 in which the step of connecting includes the step of generating the IPC and TCP/I P request 
through a web-based GUI. 

14. The method of claim 8 in which the object server responds to the translated object requests by 

30 

gathering Information concerning the network element, and conveying the information concerning the network 
node that has been gathered to the remote work station by at least by one of the ways of 

dynamically generating a web-page visual display associated with the network element being controlled for 
-35 interfacing with the remote work station to display the gathered information. 

15. The method of claim 14 in which the step of gathering includes the step of gathering network element information 
concerning at least one of the items of network element information of 

"^0 a list of all active alarms, 

a summary of system alarms, and 

a detailed indication of the status of the network element. 

45 

16. The method of claim 15 in which the step of gathering includes the step of selectively gathering all of the items of 
information. 



9. 

5 



17. The method of claim 8 in which the step of translating includes the step of communication with the object server 
through a distributed object request architecture to provide a consistent interface to the managed object that hides 
implementation details associated with the object manager. 

18. The method of claim 1 7 in which the distributed object request architecture is CORBA architecture. 

19. The method of claim 8 in which the CORBA architecture functions as an IPC for functions residing on the object 
server to eliminate the need for platform specific language for the object oriented program at the remote station. 

20. The method of claim 8 in which the CORBA architecture functions as an IPC for functions residing on the object 
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server to provide for distribution of functionality to multiple work station processors. 

21 . The method of claim 8 in which communication between the network element and the object server is through use 
of a network management protocol. 

5 

22. The method of claim 1 wherein the network management protocol is the simple network management protocol. 

23. The method of claim 21 including the step of obtaining system status associated with the network element by 
polling and auditing pursuant to the simple network management protocol. 

10 

24. The method of claim 21 including the step of providing real-time notification of alarm conditions at the network 
element through the use of network management protocol event manager. 

25. The method of claim 21 including the step of providing command and control signals to the network element through 
15 use of simple network management protocol set operation. 

26. The method of claim 8 in which 

the object server is part of an element management server that also includes a web server, and including the 
20 step of 

displaying command and alarm output information from the network element as a web browser-based display 
through use of the web server. 

25 27. The method of claim 26 in which 

the element management server also includes an executive control processor, and including the step of 

sending the command and alarm output information from the network element that is displayed through use 
30 of the web server to the executive control processor. 

28. The method of claim 1 2 including the steps of 

storing network element information concerning the network at the element management server and 

35 

selectively providing the stored network element information to a plurality of different work stations. 

29. The method of claim 8 including the step of sending from the network element event and alarm notifications to the 
object server through use of a network management protocol. 

40 

30. The method of claim 29 including the step of Issuing commands from the network element to obtain input information 
from the work station running the object oriented program to the object server through the use of the network 
management protocol. 
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The user login identifier is invalid. 1 
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Too many client sessions are already active. 1 


Too many client applications are already active for the specified login- 
host combination. 


The specified client session id is invalid or no longer known 1 


The specified client application id is invalid or no longer known. 


The specified instance id is invalid (e.g. Nulllnstanoe is specified but 
not accepted in the current application ooidext). 


The specified netirark element instana id i$ invalid or no longer 
known. 


The specified managed okiiect instance id is invalid or no longer 
known. 


The specified attribute code is not defined for the target managed 

oiaect. 


No managed object insUnoe contains a matching key list 1 


The specified filter for either an event or alarm contained one or more 
invalid criteria. 


The specified filler id Tor either an event or alarm is invalid or no 
longer known. 


\ The specified network element instance is isolated. 1 


1 The request could not be satisfied because of an EMS Server error. | 


1 An invalid operation was attempted. 1 


1 Access permission was nol granted for the corrcnl operation request. | 


1 Sofiware version mismatch detected. 1 


A crilical resource has been kisl since the last client application 
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